Apache Tapestry একটি শক্তিশালী Java-based framework, যা ডেভেলপারদের জন্য কাস্টম অ্যানোটেশন তৈরি এবং ব্যবহার করার ক্ষমতা প্রদান করে। Tapestry এর অ্যানোটেশনগুলি অনেক ধরনের কার্যকারিতা বাস্তবায়ন করতে সাহায্য করে, যেমন ফর্ম ভ্যালিডেশন, লজিক্যাল কনফিগারেশন, এবং ডিপেন্ডেন্সি ইনজেকশন। আপনি যদি টেপেস্ট্রির মধ্যে আরও কাস্টম কার্যকারিতা যোগ করতে চান, তবে কাস্টম অ্যানোটেশন তৈরি করা খুবই উপকারী হতে পারে।

এই টিউটোরিয়ালে, আমরা কাস্টম অ্যানোটেশন তৈরি করার পদ্ধতি এবং তা কিভাবে Tapestry প্রজেক্টে ব্যবহার করতে হয় তা দেখব।

কাস্টম অ্যানোটেশন তৈরি এবং ব্যবহার

ধাপ ১: কাস্টম অ্যানোটেশন তৈরি করা

Java তে একটি কাস্টম অ্যানোটেশন তৈরি করতে, প্রথমে আপনাকে একটি সাধারণ annotation interface তৈরি করতে হবে। Tapestry এর মধ্যে কাস্টম অ্যানোটেশন তৈরির জন্য, আপনি সেই অ্যানোটেশনটির উপর ভিত্তি করে কোনো নির্দিষ্ট আচরণ (behavior) যুক্ত করতে পারেন।

উদাহরণ:

ধরা যাক, আপনি একটি কাস্টম অ্যানোটেশন তৈরি করতে চান যা একটি ফিল্ডের উপর একটি minLength ভ্যালিডেশন প্রয়োগ করবে। এতে ফিল্ডের মান যদি minLength এর চেয়ে কম হয়, তবে তা বৈধ হবে না।

1. CustomValidation.java (কাস্টম অ্যানোটেশন):

package com.example.annotations;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

// Define the annotation for fields (ElementType.FIELD)
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
public @interface CustomValidation {
    int minLength() default 5;  // Minimum length for the field value
}

• @Target(ElementType.FIELD): এটি নির্দেশ করে যে এই অ্যানোটেশনটি শুধুমাত্র ফিল্ডে ব্যবহার করা হবে।
• @Retention(RetentionPolicy.RUNTIME): এটি নিশ্চিত করে যে অ্যানোটেশনটি রানটাইমে উপলব্ধ থাকবে।

এই অ্যানোটেশনটি আমরা Tapestry ফিল্ডগুলিতে ব্যবহার করতে পারব।

ধাপ ২: কাস্টম অ্যানোটেশন লজিক তৈরি করা

এখন, আমরা কাস্টম অ্যানোটেশনটির জন্য validation logic তৈরি করব। আমরা একটি service তৈরি করব যা আমাদের কাস্টম অ্যানোটেশন প্রক্রিয়া করবে এবং যাচাই করবে যে ইনপুট ফিল্ডের মান সঠিক কিনা।

2. CustomValidationService.java (কাস্টম ভ্যালিডেশন সার্ভিস):

package com.example.services;

import com.example.annotations.CustomValidation;
import org.apache.tapestry5.annotations.Inject;
import org.apache.tapestry5.ioc.annotations.UsesServices;

import java.lang.reflect.Field;

@UsesServices(ValidationService.class)
public class CustomValidationService {

    // Inject a Tapestry service or any other needed service here
    @Inject
    private ValidationService validationService;

    // Method to validate fields with the CustomValidation annotation
    public void validate(Object object) throws IllegalAccessException {
        // Iterate over fields of the given object
        for (Field field : object.getClass().getDeclaredFields()) {
            // Check if the field is annotated with @CustomValidation
            if (field.isAnnotationPresent(CustomValidation.class)) {
                CustomValidation validation = field.getAnnotation(CustomValidation.class);
                field.setAccessible(true);
                String fieldValue = (String) field.get(object); // get the value of the field
                // Validate the field value based on the minLength constraint
                if (fieldValue != null && fieldValue.length() < validation.minLength()) {
                    throw new IllegalArgumentException("Field " + field.getName() + " must have at least " + validation.minLength() + " characters.");
                }
            }
        }
    }
}

• validate মেথড: এই মেথডটি ইনপুট object এর প্রতিটি ফিল্ড পরীক্ষা করে, এবং যদি কোনো ফিল্ডে CustomValidation অ্যানোটেশন থাকে, তবে এটি সেই ফিল্ডের ভ্যালু যাচাই করে।
• যদি ভ্যালু minLength এর চেয়ে কম হয়, তবে একটি IllegalArgumentException ছুড়ে দেয়া হবে।

ধাপ ৩: কাস্টম অ্যানোটেশন ব্যবহার করা

এখন, আমাদের তৈরি কাস্টম অ্যানোটেশন ব্যবহার করতে হবে। আমরা একটি Java ক্লাস তৈরি করব যেখানে ফিল্ডগুলো কাস্টম অ্যানোটেশনের সাথে ব্যবহার করা হবে।

3. User.java (ফিল্ডে কাস্টম অ্যানোটেশন ব্যবহার):

package com.example.pages;

import com.example.annotations.CustomValidation;
import org.apache.tapestry5.annotations.Property;

public class User {

    @Property
    @CustomValidation(minLength = 8)  // Applying custom validation with a minimum length of 8
    private String username;

    @Property
    @CustomValidation(minLength = 6)  // Minimum length 6 for password
    private String password;

    // Getter and Setter for username and password
    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    public String getPassword() {
        return password;
    }

    public void setPassword(String password) {
        this.password = password;
    }
}

এখানে:

• @CustomValidation অ্যানোটেশনটি username এবং password ফিল্ডে ব্যবহার করা হয়েছে। এতে minLength সেট করা হয়েছে যাতে ফিল্ডের ভ্যালু কমপক্ষে ৮ এবং ৬ অক্ষরের হতে হবে।

ধাপ ৪: কাস্টম অ্যানোটেশন যাচাই করা

এখন, আপনাকে এই কাস্টম অ্যানোটেশন যাচাই করার জন্য একটি মেথড তৈরি করতে হবে, যা Tapestry সিস্টেমে ব্যবহৃত হবে।

4. UserService.java (কাস্টম ভ্যালিডেশন সার্ভিস কল করা):

package com.example.services;

import com.example.pages.User;
import org.apache.tapestry5.ioc.annotations.Inject;

public class UserService {

    @Inject
    private CustomValidationService customValidationService;  // Injecting custom validation service

    public void validateUser(User user) throws IllegalAccessException {
        customValidationService.validate(user);  // Call the custom validation service
    }
}

• এই মেথডটি User অবজেক্টটি গ্রহণ করে এবং CustomValidationService এর validate মেথড কল করে, যাতে ফিল্ডগুলির ভ্যালিডেশন করা যায়।

সারাংশ

এখন আপনি জানেন কিভাবে Tapestry ফ্রেমওয়ার্কে কাস্টম অ্যানোটেশন তৈরি এবং ব্যবহার করতে হয়। এই প্রক্রিয়াতে:

1. একটি কাস্টম অ্যানোটেশন তৈরি করা হয়েছে যা নির্দিষ্ট ফিল্ডের জন্য minLength চেক করে।
2. একটি কাস্টম সার্ভিস তৈরি করা হয়েছে যা অ্যানোটেশনটির সাহায্যে ডেটা ভ্যালিডেশন পরিচালনা করে।
3. সিস্টেমে কাস্টম অ্যানোটেশন ব্যবহার করে ফিল্ডের উপর ভ্যালিডেশন প্রক্রিয়া করা হয়েছে।

Tapestry-তে কাস্টম অ্যানোটেশন তৈরি করার মাধ্যমে আপনি আপনার অ্যাপ্লিকেশনকে আরও নমনীয়, শক্তিশালী এবং নিরাপদ করতে পারেন।